package cn.tedu.property.management.mapper;

import cn.tedu.property.management.pojo.entity.VisitPeople;
import cn.tedu.property.management.pojo.vo.VisitPeopleListItemVO;
import cn.tedu.property.management.pojo.vo.VisitPeopleStandardVO;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;

import java.util.List;

/**
 * 处理访客数据的Mapper接口
 *
 * @author ansheng
 * @version 0.0.1
 */
@Repository
public interface VisitPeopleMapper{
    /**
     * 插入访客数据
     *
     * @param visitPeople 访客数据
     * @return 受影响的行数
     */
    int insert(VisitPeople visitPeople);

    /**
     * 批量插入访客数据
     *
     * @param visitPeopleList 若干个访客数据的List集合
     * @return 受影响的行数
     */
    int insertBatch(List<VisitPeople> visitPeopleList);

    /**
     * 根据id删除访客数据
     *
     * @param id 访客id
     * @return 受影响的行数
     */
    int deleteById(Long id);

    /**
     * 根据若干个id批量删除访客数据
     *
     * @param ids 若干个访客id的数组
     * @return 受影响的行数
     */
    int deleteByIds(Long[] ids);

    /**
     * 修改访客数据
     *
     * @param visitPeople 封装了被修改的
     * @return 受影响的行数
     */
    int update(VisitPeople visitPeople);

    /**
     * 统计访客数据的数量
     * @return 访客数据的数量
     */
    int count();

    /**
     * 根据 访客名称 统计访客数据的数量
     * @param name 访客名称
     * @return 匹配 访客名称 的访客数据的数量
     */
    int countByName(String name);

    /**
     * 根据 相册名称 和 "非此id" 统计数量
     * @param id 相册的id
     * @param name 相册名称
     * @return 匹配 相册名称 和 相册id 的相册数据的数量
     */
    int countByNameAndNotId(
            @Param("id") Long id,
            @Param("name") String name
    );

    /**
     * 根据访客id查询访客详情
     * @param id 访客id
     * @return 匹配的访客详情，如果没有匹配的数据，则返回null
     */
    VisitPeopleStandardVO getStandardById(Long id);

    /**
     * 查询访客列表
     * @return 访客列表
     */
    List<VisitPeopleListItemVO> list();
}
